configure vm cpus

configure vm vm_name cpus num_cpus

Description

Configures an existing virtual machine (VM) CPU allocation.

Syntax Description

vm Designates a virtual machine.
vm_name Specifies the VM name to configure.
cpus Designates specifying the number of CPUs to allocate to the VM.
num_cpus Specifies the number of CPUs to allocate to the VM. Range is 1–2. The default is 1.

Default

By default, the number of CPUs allocated is 1.

Usage Guidelines

The number of CPUs allocated to a VM is set when the VM is created (default is 1), but you can change the allocation with this command. To view the number of CPUs currently allocated to a VM, use the command show vm {vm_name | detail}.

This command does not take effect until the next time the guest VM is started.

The Integrated Application Hosting (IAH) feature requires the Solid State Storage Device SSD-120.

Example

The following example changes the number of CPUs allocated to VM "vm1" to 2:

# configure vm vm1 cpus 2

History

This command was first available in ExtremeXOS 30.3.

Platform Availability

This command is available on all platforms that support the Integrated Application Hosting (IAH) feature and have a Core or Premier license installed. For a list of platforms that support the IAH feature and for information about licenses, see the Switch Engine v33.1.1 Licensing Guide .